<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
	"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<head>
<title>Public Transport Line Diagram</title>
</head>
<body>

<h1>Public Transport Line Diagram</h1>

<h2>Quick Access</h2>

<h3>By network and line number</h3>

<form action="api/sketch-line" method="get" accept-charset="UTF-8">
  <strong>Network</strong>: <input name="network" type="text" size="40"/><br/>
  The value of the tag <em>network</em> of the relation(s) to consider. A working example is <em>VRR</em>
  for the German <em>Verkehrsverbund Rhein-Ruhr</em>.<br/>
  <strong>Line number</strong>: <input name="ref" type="text" size="40"/><br/>
  The value of the tag <em>ref</em> of the relation(s) to consider. A working example is <em>625</em>.<br/>
  <strong>Operator</strong>: <input name="operator" type="text" size="40"/><br/>
  Usually, you can leave this field empty. Only if the combination of Network and Line Number is not unique, you can use this to make your query more precise.<br/>
  <input type="submit"/>
</form>

<p>You can access this service directly with an URL of the form<br/>
http://78.46.81.38/api/sketch-line?network=<em>network</em>&amp;ref=<em>ref</em>
<p>

<h2>Full Access</h2>

<h3>A form with all possible parameters</h3>

<form action="api/sketch-line" method="get" accept-charset="UTF-8">
  <strong>Network</strong>: <input name="network" type="text" size="40"/><br/>
  The value of the tag <em>network</em> of the relation(s) to consider. A working example is <em>VRR</em> for the German <em>Verkehrsverbund Rhein-Ruhr</em>.<br/>
  <strong>Line number</strong>: <input name="ref" type="text" size="40"/><br/>
  The value of the tag <em>ref</em> of the relation(s) to consider. A working example is <em>625</em>.<br/>
  <strong>Operator</strong>: <input name="operator" type="text" size="40"/><br/>
  Usually, you can leave this field empty. Only if the combination of Network and Line Number is not unique, you can use this to make your query more precise.<br/>
  <strong>Correspondences</strong>: <input name="correspondences" type="text" size="10"/><br/>
  A nonempty value in this field enables the display of correspondences. This slows down the response
  times but gives more information. The value is interpreted as maximum acceptable distance in meters
  between two stations or bus stops to still be acceptable for changing vehicles. The default value is 100.<br/>
  <strong>Width</strong>: <input name="width" type="text" value="700" size="10"/><br/>
  The width of the generated SVG in pixels. Default is 700.<br/>
  <strong>Height</strong>: <input name="height" type="text" value="495" size="10"/><br/>
  The heigth of the generated SVG in pixels. Default is 495.<br/>
  <strong>Font size of stop names</strong>: <input name="font-size" type="text" size="10"/><br/>
  The font size in pixels for the stopname in the generated SVG. Default is is empty field.
  This means that the generator takes font size 10 for lines displayed in two rows and font size 16
  for lines displayd in one row.<br/>
  <strong>Force number of rows</strong>: <input name="force-rows" type="text" size="10"/><br/>
  This field can have values 1 or 2 or can be empty. If it is empty, the generator chooses whether to
  display the line in one or two rows. If it is set to 1 resp. 2, the generator displays the line
  in an case in one resp. two rows.<br/>
  <strong>Maximum correspondences per row</strong>: <input name="max-cors-per-line" type="text" size="10"/><br/>
  The limit for the acceptable number of line numbers to be printed per line. This option is only
  effective when correspondences are enabled. Its default value is 6.<br/>
  <strong>Maximum correspondences below</strong>: <input name="max-cors-below" type="text" size="10"/><br/>
  The limit for the acceptable number of line numbers to be printed below the line bar. This option is only
  effective when correspondences are enabled. Its default value is 0.<br/>
  <strong>Style</strong>: <input name="style" type="text" size="40"/><br/>
  This parameter makes the generator using an existing style for formatting the diagram. A working example
  is <em>wuppertal</em> for a style with German translations and abbreviations.<br/>
  <input type="submit"/>
</form>

<h3>Using style files</h3>

<form action="api/sketch-options" method="get" accept-charset="UTF-8">
  <input type="text" name="style" size="40"/>
  <input type="hidden" name="action" value="edit"/>
  <input type="submit"/>
</form>

These style files allow to maintain a set of preferences. For example, an url like<br/>
http://78.46.81.38/api/sketch-line?style=wuppertal&amp;network=<em>network</em>&amp;ref=<em>line number</em><br/>
will show you a diagram with German abbrevations, while
http://78.46.81.38/api/sketch-line?style=padua&amp;network=<em>network</em>&amp;ref=<em>line number</em><br/>
would have Italian abbrevations. To edit the styles, type <em>wuppertal</em> or <em>padua</em> in the above box an click the button.

<h3>Opening hours</h3>

For the times of the week when the bus service is operational, the generator uses the tag <emph>opening_hours</emph>. These times manifest themselves in two ways:
<ul>
<li>For every line which has operation times set, a text line <emph>operates ...</emph> is added below the line number.</li>
<li>Connections are only shown between services that operate at a common time. I.e. a night bus doesn't appear on the list of correspondences for a service running only over the day.</li>
</ul>

The accepted format for <emph>opening_hours</emph> is as follows: Different entries are separated by colons. An entry consists of either a day (one of <emph>Mo</emph>, <emph>Tu</emph>, <emph>We</emph>, <emph>Th</emph>, <emph>Fr</emph>, <emph>Sa</emph> or <emph>Su</emph>) or a range of days (e.g. <emph>Mo-Fr</emph>), a blank and then a range of times in the format <emph>hh:mm-hh:mm</emph>. Times may not surpass midnight and day ranges may not surpass sunday. The timespans are considered additve. Some eaxmples:
<ul>
<li><emph>Mo-Fr 06:00-20:00</emph>: The service runs from monday to friday from 06h00 to 20h00.</li>
<li><emph>Mo-Su 06:00-20:00</emph>: The service runs daily from 06h00 to 20h00.</li>
<li><emph>Mo-Fr 00:00-24:00</emph>: The service runs 24 hours from monday to friday but not on the weekend.</li>
<li><emph>Mo-Su 21:00-24:00, 00:00-00:30; Su 07:00-10:00</emph>The service runs every evening from 21:00 to half past midnight and also on sunday mornings. Note that the timespan 21:00-00:30 has to be split.</li>
<li><emph>Mo-Fr 09:00-12:00, 15:00-18:00; We 09:00-12:00</emph>: This is the same as <emph>Mo-Fr 09:00-12:00, 15:00-18:00</emph>, because the wednesday is contained in <emph>Mo-Fr</emph>.</li>
<li><emph>Mo-Fr 09:00-12:00; Mo-Tu 15:00-18:00; Th-Fr 15:00-18:00</emph>. This service is not operational on wednesday afternoons.</li>
</ul>

<h1>Public Transport Line Map</h1>

<h2>Access By network and line number</h2>

<form action="api/draw-line" method="get" accept-charset="UTF-8">
  <strong>Network</strong>: <input name="network" type="text" size="40"/><br/>
  The value of the tag <em>network</em> of the relation(s) to consider. A working example is <em>VRR</em>
  for the German <em>Verkehrsverbund Rhein-Ruhr</em>.<br/>
  <strong>Line number</strong>: <input name="ref" type="text" size="40"/><br/>
  The value of the tag <em>ref</em> of the relation(s) to consider. A working example is <em>625</em>.<br/>
  <strong>Scale</strong>: <input name="scale" type="text" value="10.0" size="40"/><br/>
   The scale in meter per pixel. Bigger values mean smaller maps. A useful scale for bus services is <em>10.0</em>. For train services, <em>25.0</em> or bigger may suit better.<br/>
  <strong>Pivot meridian</strong>: <input name="pivot-lon" type="text" size="10"/><br/>
   The used projection is Sinusoidal, and this is the central meridian for this projection. If you leave the field empty, the algorithm will detect a suitable value on its own.<br/>
  <strong>Font size of stop names</strong>: <input name="font-size" value="12.0" type="text" size="10"/><br/>
  The font size in pixels for the stopname in the generated SVG.<br/>
  <input type="submit"/>
</form>

<p>You can access this service directly with an URL of the form<br/>
http://78.46.81.38/api/draw-line?network=<em>network</em>&amp;ref=<em>ref</em>
<p>

</body>
</html>
